home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / earkit / browser / checkhtml / docs / english / checkhtml.doc next >
Text File  |  1998-05-24  |  16KB  |  479 lines
  1.  
  2.                       Table of Contents
  3.  
  4.   Copyright                   - Copyright information
  5.   Distribution                - Copying conditions
  6.   Disclaimer                  - Legal Information
  7.   SGMLS License & Disclaimer  - SGMLS Legal Information
  8.   Trademarks                  - Trademark information
  9.   Support/Updates             - How to get updates and support
  10.   Author                      - How to reach the author
  11.  
  12.   Description                 - What is CheckHTML?
  13.   Requirements                - Requirements for using CheckHTML
  14.  
  15.   Installation                - How to install CheckHTML
  16.  
  17.   History                     - Revision history of CheckHTML
  18.   Todo                        - Todo list
  19.   Known problems              - List of known problems
  20.   Acknowledgments             - Acknowledgments
  21.   Please rate                 - Please rate CheckHTML
  22.   References                  - SGML References
  23.  
  24.  
  25.  
  26. Copyright
  27. ---------
  28.  
  29. CheckHTML, CountStrings, SelectString and the documentation are copyright
  30. 1997-1998 Kai Hofmann. All rights reserved!
  31.  
  32. - Permission for COMMERCIAL USE is only given by an extra available commercial
  33.   license that must be validated!
  34.   Contact me directly for this license, because it will be individually handed
  35.   out per your needs!
  36.  
  37. - Permission is hereby granted, without written agreement and without license,
  38.   to USE this software and its documentation for any NON-COMMERCIAL purpose,
  39.   provided that the above copyright notice and the following paragraph appear
  40.   in all copies of this software (Non-commercial includes Giftware!).
  41.  
  42.   Please send me a full version of your product at no cost including free
  43.   updates!
  44.   Money is welcome (For Bank Account see author - but *ONLY* send in DM
  45.   to this Bank Account!).
  46.  
  47.  
  48.  
  49. Distribution
  50. ------------
  51.  
  52. Permission is hereby granted, without written agreement and without license or
  53. royalty fees, to copy and distribute this software and its documentation for
  54. any purpose, provided that the above copyright notice and the following
  55. paragraphs appear in all copies of this software, to:
  56.  
  57. - All who will distribute this software for free!
  58. - All free accessible INTERNET servers!
  59. - All Aminet® sites
  60. - Fred Fish for his great Amiga-Software-Library
  61. - The German SAAR AG PD-Library
  62. - Angela Schmidt's Meeting Pearls series
  63. - All others who do NOT take more than US$ 5.- for one disk that includes this
  64.   software!
  65.  
  66.  
  67. IMPORTANT NOTE:
  68.  
  69. This package may not be included on any further Aminet CD-ROMs unless authors
  70. contributing their software to the CD-ROM, (without mentioning distribution
  71. "NoCD") are granted a copy of the CD *completely* *free* *of* *charge*.
  72.  
  73. The Meeting Pearls IV CD-ROM demonstrates that a Freebie policy is also
  74. possible with "very-low-budget" CD-ROMs (*), so Aminet should quickly
  75. re-establish the same Freebie policy it used up to Aminet CD 13.
  76.  
  77. (*) Suggested retail price for MP4 is DM 14,95/US$ 12/£ 8.95.
  78.  
  79.  
  80.  
  81. DISCLAIMER
  82. ----------
  83.  
  84. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  85. LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER
  86. PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  87. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  88. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
  89. QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  90. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  91.  
  92. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
  93. COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS
  94. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  95. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  96. THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  97. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE
  98. PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY
  99. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  100.  
  101. THE AUTHOR HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
  102. ENHANCEMENTS, OR MODIFICATIONS.
  103.  
  104.  
  105.  
  106.  
  107. LICENSE AND DISCLAIMER OF WARRANTIES
  108.  
  109. Standard Generalized Markup Language Users' Group (SGMLUG)
  110. SGML Parser Materials
  111.  
  112. 1. License
  113.  
  114. SGMLUG hereby grants to any user: (1) an irrevocable royalty-free, worldwide,
  115. non-exclusive license to use, execute, reproduce, display, perform and
  116. distribute copies of, and to prepare derivative works based upon these
  117. materials; and (2) the right to authorize others to do any of the foregoing.
  118.  
  119. 2. Disclaimer of Warranties
  120.  
  121. (a) The SGML Parser Materials are provided "as is" to any USER.  USER assumes
  122.     responsibility for determining the suitability of the SGML Parser Materials
  123.     for its use and for results obtained.  SGMLUG makes no warranty that any
  124.     errors have been eliminated from the SGML Parser Materials or that they can
  125.     be eliminated by USER.  SGMLUG shall not provide any support maintenance or
  126.     other aid to USER or its licensees with respect to SGML Parser Materials.
  127.     SGMLUG shall not be responsible for losses of any kind resulting from use
  128.     of the SGML Parser Materials including (without limitation) any liability
  129.     for business expense, machine downtime, or damages caused to USER or third
  130.     parties by any deficiency, defect, error, or malfunction.
  131.  
  132. (b) SGMLUG DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, ARISING OUT OF OR
  133.     RELATING TO THE SGML PARSER MATERIALS OR ANY USE THEREOF, INCLUDING
  134.     (WITHOUT LIMITATION) ANY WARRANTY WHATSOEVER AS TO THE FITNESS FOR A
  135.     PARTICULAR USE OR THE MERCHANTABILITY OF THE SGML PARSER MATERIALS.
  136.  
  137. (c) In no event shall SGMLUG be liable to USER or third parties licensed by
  138.     USER for any indirect, special, incidental, or consequential damages
  139.     (including lost profits).
  140.  
  141. (d) SGMLUG has no knowledge of any conditions that would impair its right to
  142.     license the SGML Parser Materials.  Notwithstanding the foregoing, SGMLUG
  143.     does not make any warranties or representations that the SGML Parser
  144.     Materials are free of claims by third parties of patent, copyright
  145.     infringement or the like, nor does SGMLUG assume any liability in respect
  146.     of any such infringement of rights of third parties due to USER's operation
  147.     under this license.
  148.  
  149.  
  150.  
  151. Trademarks
  152. ----------
  153.  
  154. Amiga, AmigaDOS, AmigaGuide and Workbench are registered trademarks of Amiga
  155. International, Inc.
  156. Aminet is a registered trademark of Stefan Ossowskis Schatztruhe GmbH
  157. SAS/C is a registered trademark of SAS Institute Inc.
  158.  
  159. All other trademarked names used herein are used for the purposes of
  160. identification and for the benefit of the trademark holder. No infringement of
  161. trademarks is intended. Trademarks remain the property of the trademark holder.
  162.  
  163.  
  164.  
  165. Support/Updates
  166. ---------------
  167.  
  168. - Updates will be available via Aminet®
  169. - Support will be available via the authors email address and via
  170.   http://home.pages.de/~i07m/amiga/CheckHTML.html
  171.  
  172.  
  173.  
  174. Author
  175. ------
  176.  
  177. Kai Hofmann
  178. Arberger Heerstraße 92
  179. 28307 Bremen
  180. Germany
  181.  
  182. Phone: (+49)-(0)421/480780
  183. EMail: i07m@informatik.uni-bremen.de
  184. IRC  : PowerStat@#AmigaGer
  185. WWW  : http://home.pages.de/~i07m/
  186.  
  187.  
  188.  
  189.  
  190. Description
  191. -----------
  192.  
  193. CheckHTML checks whether an HTML document is conforming with the HTML (4.0) DTD.
  194. This will be done by using the sgmls parser from James Clark, the HTML DTD and
  195. a small Shell script.
  196. CheckHTML can verify HTML 4.0, HTML 3.2 and HTML 2.0 documents. Newer HTML
  197. versions can be easily supported by placing the new DTD into the 'sgml:'
  198. directory and adding their public identifier to the 'CATALOG' file. The
  199. upcoming XML standard could be easily supported the same way!
  200.  
  201. Please note, that all your HTML documents must begin with the following line
  202. for backward compatibility with HTML 3.2:
  203.  
  204. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  205.  
  206. Otherwise (especially when using CSS) use:
  207.  
  208. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  209.  
  210. or
  211.  
  212. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN">
  213.  
  214. when using frames.
  215.  
  216. These lines are SGML code and identify the document to be HTML 4.0 - you can
  217. also use one of the HTML3.2 or HTML 2.0 identifiers (See 'CATALOG' file for
  218. more):
  219.  
  220. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  221. <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
  222.  
  223. For more about the famous 'sgmls' parser please download
  224. 'Aminet:dev/lang/sgmls.lha'
  225.  
  226. Template:
  227.  
  228. CheckHTML FILE,QUIET/S
  229.  
  230. Using CheckHTML without the FILE argument will open a requester where you can
  231. select multiple files!
  232. You can also use CheckHTML from the Workbench with the supplied icon file.
  233. Click CheckHTML first and then double click a HTML document.
  234.  
  235.  
  236. Toolmanager 3.0 users can find a preference within the archive.
  237.  
  238.  
  239. If you also want to check the correctness of the links within your HTML
  240. documents, please take a look at CheckLink from Fabio Rotondo which can be
  241. found on Aminet.
  242.  
  243.  
  244.  
  245. Requirements
  246. ------------
  247.  
  248. - OS 2.04
  249.  
  250.  
  251.  
  252.  
  253. Installation
  254. ------------
  255.  
  256. Use the installer script!
  257. (The Installer must be in your system-path!)
  258.  
  259.  
  260. Should you want to install by hand, do the following:
  261.  
  262. - Place c/sgmls, c/CountStrings, c/SelectString and s/CheckHTML somewhere
  263.   into your path
  264. - Create a SGML directory, assign 'SGML:' to it and copy the SGML dir from the
  265.   archive to it.
  266. - Copy the  documentation if needed (don't forget to use
  267.   WrapGuide on it if running under a pre V40 System).
  268.  
  269.  
  270.  
  271. History
  272. -------
  273.  
  274. 29.04.1997 -    First release on Aminet
  275. 03.06.1997 -    Second release on Aminet
  276.         * Improved documentation
  277.         * Added some @{AMIGAGUIDE} V40 features to the documentation
  278.         * Improved installer script
  279.         * Added CountStrings
  280.         * Added SelectString
  281.         * CheckHTML now asks for (multiple) files when started without
  282.           arguments
  283.         * Added German documentation
  284.         * HTML 3.2 Final DTD
  285.         * Renamed ISOlat1.sgml to ISOlat1.ent
  286. 30.06.1997 -    Third release on Aminet
  287.         * Added MagicWB readme
  288.         * SGMLS now compiled with SAS/C® 6.57
  289.         * Added new Eric Gerad icon
  290.         * Added Toolmanager 3.0 preferences
  291.         * Added "Finished" output for WB
  292. 29.01.1997 -    Fourth release on Aminet
  293.         * HTML 4.0 Final DTD
  294.         * Fixed installer script problem
  295.  
  296.  
  297.  
  298. Todo
  299. ----
  300.  
  301. - Uninstaller
  302. - Add TM3 prefs by Installer script
  303. - Accept multiple files as arguments
  304. - Accept pattern matching
  305. - Scan directories recursivly
  306. - MUI Interface
  307.   * Load the HTML document and highlight the problems
  308.   * Drop HTML documents onto an appicon
  309.  
  310.  
  311.  
  312. Known problems
  313. --------------
  314.  
  315. - Netscape or Microsoft extensions are not supported - you can add them by
  316.   yourself to the DTD, but CheckHTML will only support official standards!
  317.   You can find some DTDs at http://www.webtechs.com/
  318.  
  319. - The components of CheckHTML are placed in various directories and not in
  320.   only one. This happens to be the rules of AmigaOS and SGML.
  321.   Within the 'SGML:' directory only SGML documents and DTDs should be placed.
  322.   CheckHTML is placed in 'S:' because this is the place for Amiga Shell
  323.   scripts - for the same reason 'sgmls' is placed into 'C:'.
  324.   By running the installer script in expert modus you can change the
  325.   destinations for all files.
  326.  
  327. - Some of you wrote that they can't download the CheckHTML archive from
  328.   Aminet - this is a problem of your local mirror - and not a problem of
  329.   the CheckHTML release.
  330.  
  331. - You can't redirect the output of CheckHTML to a file, because this is
  332.   what sgmls sends to stderr.
  333.  
  334. - CheckHTML can generate English output only as long as sgmls is not
  335.   localized (very difficult task!)
  336.  
  337. - When CheckHTML won't run, try to set the script flag for it.
  338.  
  339. - HTML 4.0 is based on ISO10646 16bit characters - CheckHTML only supports
  340.   ISO8859-Latin1 8bit characters for now, don't worry, because this is
  341.   backward compatible!
  342.  
  343.  
  344.  
  345. Acknowledgments are going to the following people:
  346.  
  347. Rita Reichl         : for correcting my English and being my inspiration
  348.  
  349. James Clark         : for the famous sgmls parser
  350. People at Cern      : for HTML
  351. W3 Consortium       : for the standardized HTML DTDs
  352. Udo Schuermann      : for WrapGuide
  353. Stefan Kost         : for ag2txt
  354. Fabio Rotondo       : for CheckLink
  355.  
  356. James Cooper,
  357. Steve Krueger,
  358. Doug Walker         : For supporting SAS/C® after SAS suspends the support.
  359.  
  360. Martin Huttenloher  : for MagicWB
  361. Eric Gerard         : for his great icons
  362.  
  363.  
  364.  
  365. Please rate
  366. -----------
  367.  
  368. Please rate CheckHTML. To do so, send an email to
  369. aminet-server@wuarchive.wustl.edu with the following content:
  370.  
  371. RATE comm/www/CheckHTML.lha <num>
  372.  
  373. where <num> is a mark from 0..10 with 10 being the best.
  374. You can rate several programs in one mail.
  375.  
  376. Thank you!
  377.  
  378.  
  379.  
  380. References
  381. ----------
  382.  
  383. The SGML Handbook
  384. Charles F. Goldfarb
  385. First Edition
  386. Oxford University Press, Walton Street, Oxford (USA); 1990
  387. ISBN 0-19-853737-9
  388.  
  389. SGMLS - SGML Parser
  390. James Clark
  391. http://www.jclark.com/
  392. Amiga port in 06.1995 by Kai Hofmann
  393. http://home.pages.de/~i07m/amiga/SGMLSannounce.html
  394.  
  395. Webtechs
  396. http://www.webtechs.com/
  397. DTDs can be found here
  398.  
  399. W3C - World Wide Web Consortium
  400. http://www.w3.org/
  401.  
  402. Kai Hofmann's SGML page
  403. http://home.pages.de/~i07m/SGML.html
  404.  
  405. PhoneLog Standard
  406. http://home.pages.de/~i07m/pi/PhoneLog.html
  407.  
  408.  
  409.  
  410.                  This product is based on or uses parts of
  411.  
  412.                      MagicWB - The Workbench Enhancer
  413.                      --------------------------------
  414.  
  415.                  Copyright © 1992-1997, Martin Huttenloher
  416.  
  417. If  you  use  and like this product you should very much consider to take a
  418. look  at  MagicWB,  which  is the authentic source of the style, colors and
  419. design  elements  contained  in  this  package.   It  features  hundreds of
  420. original  icons,  patterns, image-drawers,  dock-brushes and some specially
  421. designed  high-quality  fonts  to  improve the comfort & legibility of your
  422. daily Workbench session.
  423.  
  424. What  is  MagicWB?   MagicWB  is  a full replacement for the Graphical User
  425. Interface  of the Workbench and has become the standard visual interface on
  426. the  Amiga.  Over the last years MagicWB has received various merits and an
  427. overwhelming  response from Amiga magazines and users worldwide proclaiming
  428. it  "a  must  for  all  Amiga  users".   Even  commercial  applications are
  429. supporting the multi-colored look & style of MagicWB.
  430.  
  431. Get yourself the latest version of MagicWB and see for yourself the wonders
  432. it  can  do by automatically transforming your old and dull Amiga Workbench
  433. into  an impressive workstation environment that will be the envy of all PC
  434. Windows  and  Mac users.  Update yourself to the state-of-the-art workbench
  435. standard  everyone uses on the Amiga!  It is also your key to enjoy the new
  436. look & feel of many applications and other MWB add-ons and extensions.
  437.  
  438. MagicWB  is  distributed as shareware.  Get yourself the latest FREE PUBLIC
  439. RELEASE of MagicWB now:  It is called
  440.  
  441.                              ----------------
  442.                               MagicWB21p.lha
  443.                              ----------------
  444.  
  445. and  can  be found everywhere on Aminet (or your local BBS or public domain
  446. series).   Install it and witness the instant magic it performs on your old
  447. Amiga  Workbench.   Also  included  is the latest SASG registration program
  448. with which you can order and get the full registered version of MagicWB.
  449.  
  450.              If you want to order directly, feel free to send
  451.  
  452.                   DM 30.- or US$ 20.- (cash, no checks!)
  453.  
  454.                                     to
  455.  
  456.                             Martin Huttenloher
  457.                              Am Hochstraess 4
  458.                                D-89081 Ulm
  459.                                  Germany
  460.  
  461. You  may  also  choose  to visit the official MagicWB homepage on the world
  462. wide  web.   There you can find the latest news & support and even register
  463. your  MagicWB  online  (which is much more comfortable and faster). You can
  464. even  benefit  from  various  special offers & discounts for MagicWB if you
  465. order through our website!  Come and visit MagicWB at:
  466.  
  467.                           ----------------------
  468.                            http://www.sasg.com/
  469.                           ----------------------
  470.  
  471.               Save 20% by using the discounts on our website!
  472.  
  473.            Ordering online also saves you a lot of time and work!
  474.  
  475.  
  476.  
  477. WrapGuide is Copyright 1994-1995 Udo Schuermann
  478. All rights reserved
  479.